home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / os20 / gfx / picboot.lha / PicBoot.Man < prev    next >
Text File  |  1993-02-08  |  9KB  |  242 lines
  1.  
  2.  
  3.     PicBoot 1.00                User manual                 PicBoot 1.00
  4.  
  5.  
  6.     NAME 
  7.         PicBoot 
  8.  
  9.     SYNOPSIS 
  10.         PicBoot FILES/M/A,L=LIST/S,B=BLACK/S,D=DETACH/S 
  11.  
  12.     DESCRIPTION 
  13.         Have  you  removed  all output in your 2.0 startup, and only see
  14.         an  empty  screen  during  bootup? Wouldn't it be nice to have a
  15.         picture  instead?  A picture that disappeared when the Workbench
  16.         screen was opened? 
  17.  
  18.         If  so,  PicBoot is certainly a program for you. What it will do
  19.         is  to  read  any  IFF file containing an ILBM picture, and show
  20.         that  picture.  As  soon as the Workbench screen appears (or you
  21.         press any mouse-button), the picture will go away.  
  22.  
  23.         PicBoot  features  a fast BODY-unpacker (use the BLACK option to
  24.         get  the  best  speed),  optional  auto-detaching,  and a way to
  25.         automatically  random select among any number of different files
  26.         to  show.  PicBoot  also  uses  less  memory  while  showing the
  27.         picture  compared  to IffBoot (IffBoot keeps the compressed body
  28.         in  memory  while  showing  the  picture.  Pure waste of memory.
  29.         PicBoot  will  free  that  memory  as  soon  as  the  picture is
  30.         unpacked, and will also close all files etc.).  
  31.  
  32.         To  activate  PicBoot, add a line your startup-sequence, looking
  33.         something like this: 
  34.  
  35.         PicBoot Pics:Hi-res/RockyCalvin.Pic BLACK DETACH 
  36.  
  37.         Or, if you have a list of files in "Work:Text/PicList": 
  38.  
  39.         PicBoot Work:Text/PicList LIST BLACK DETACH 
  40.  
  41.         This  line should be located very early in the Startup-Sequence,
  42.         but  keep  it  after SetPatch. PicBoot will only output any text
  43.         if it fails, so don't re-direct its output.  
  44.  
  45.         Make  sure  no program makes any output in the CLI window, since
  46.         then  the  Workbench  screen  will open with a boring CLI-window
  47.         instead...  
  48.  
  49.         Apart   from  OS  2.04,  PicBoot  doesn't  require  any  special
  50.         libraries.    The    only    non-ROM    library    required   is
  51.         iffparse.library.  
  52.  
  53.     OPTIONS 
  54.  
  55.         FILES 
  56.             This  is  the  only  required argument. Here you specify the
  57.             name  of the picture you want to view. You may enter several
  58.  
  59.  
  60.     Page 1                                           (Printed 08 Feb 93)
  61.  
  62.  
  63.     PicBoot 1.00                User manual                 PicBoot 1.00
  64.  
  65.  
  66.             files  here,  in  which case PicBoot will select one of them
  67.             randomly,  and  show that one. It may also be the name of an
  68.             ASCII  file  containing a filename list if you specified the
  69.             LIST option (see below).  
  70.  
  71.             NOTE:  The random-number generator used is quite simple, and
  72.             is  based  on the current system time. I don't know if it is
  73.             a  "good" one. If you have an algorithm you think is better,
  74.             don't be afraid to send it to me.  
  75.  
  76.         LIST 
  77.             If   this   switch  is  present,  it  instructs  PicBoot  to
  78.             interpret  the  *first*  filename  specified  in  the  FILES
  79.             argument  as  the  name  of  a  file  containing  a  list of
  80.             pictures  (any  ohter filename(s) in the FILES argument will
  81.             be  ignored).   PicBoot will then randomly select one of the
  82.             filenames in the file, and view that picture.  
  83.  
  84.             This  filelist  file  is  an ASCII (text) file with a simple
  85.             layout.  On  the  first  line  you  specify  the  number  of
  86.             filenames  in  the file. This is usually <number of lines in
  87.             file>-2  (one  line  is occupied by the count, and the other
  88.             is  the  last  linefeed). The rest of the file is simply the
  89.             files  to  view,  one  filename  per  line. So, a short file
  90.             could look like this: 
  91.  
  92.             3
  93.             Work:Pics/Comics/Calvin01.Pic
  94.             Work:Pics/Comics/Calvin02.Pic
  95.             Work:Pics/Comics/Calvin03.Pic
  96.  
  97.         BLACK 
  98.             This  will make PicBoot open up a black screen (very small 1
  99.             bitplane,  almost  a  0 bitplane screen.. :) before the real
  100.             screen  is  opened  (and this one will open behind the black
  101.             one).  Since  the black screen needs very little DMA time to
  102.             be  displayed,  the  CPU  will  get  much more access to the
  103.             CHIP-mem  rather  than  if  a  4  bitplane hires screen (ECS
  104.             system)  would  be  in  the  front.  This  can speed up BODY
  105.             unpacking  rather much (since during boot there is no screen
  106.             to hide behind... :).  
  107.  
  108.         DETACH 
  109.             This  will cause PicBoot to detach from its calling CLI when
  110.             the  picture  is  fully  loaded  etc.  If  you  specify this
  111.             option,  you  shouldn't RUN PicBoot. This option will reduce
  112.             memory  fragmentation, and will ensure that the picture gets
  113.             loaded  quickly. However, the implementation maybe isn't the
  114.             most  "system-friendly"  one  (but  there  aren't  that many
  115.             alternatives...),  hence  the  switch. I don't think it will
  116.             be any problems, but one can never know... :) 
  117.  
  118.  
  119.  
  120.     Page 2                                           (Printed 08 Feb 93)
  121.  
  122.  
  123.     PicBoot 1.00                User manual                 PicBoot 1.00
  124.  
  125.  
  126.     KNOWN BUGS AND LIMITATIONS 
  127.         I  do not know of any real bugs in PicBoot. However, there are a
  128.         few  "limitations",  compared  to  other  viewers.  One  is that
  129.         PicBoot  will  refuse  to show pictures that have a body that is
  130.         compressed  across  rows. I've come across one one picture which
  131.         seems  to  be  compressed  like  this,  so  it  seems  like some
  132.         IFF-writers  (well, at least one :) can write bad ILBMs. This is
  133.         a  bug (in the writer program), since the IFF-specs clearly says
  134.         that  one  shouldn't  compress  across  rows  (and  I understand
  135.         why... :).  
  136.  
  137.         Also,  pictures  that  have  mask  bitplane (mskHasMask) are not
  138.         supported.  I decided to not add support for this, since I don't
  139.         have  any  such picture to test it with anyway... :) If you have
  140.         such  pictures,  and wants PicBoot to be able to show them, send
  141.         me a note, and we'll see what can be done..  
  142.  
  143.         PicBoot  should work on most Amigas, but there is as yet no real
  144.         support  for the new AGA modes or extended color capabilities. I
  145.         plan  to  add  this  as  soon  as  Commodore releases the Native
  146.         Developer  Kit  here in Sweden... :( PicBoot doesn't enforce PAL
  147.         or  NTSC  depending on height or similar, so it should work nice
  148.         on both NTSC and PAL systems.  
  149.  
  150.     AUTHOR 
  151.         PicBoot  was  written  in  100% assembler by Magnus Holmgren. If
  152.         you  have any comments etc, feel free to send me a note. You can
  153.         reach me via internet on any of these addresses: 
  154.  
  155.             cmh@augs.se
  156.             magnus_holmgren@augs.se
  157.             cmh@lysator.liu.se
  158.             d91magho@und.ida.liu.se
  159.  
  160.         Fido-net    messages    should    go   to   "Magnus   Holmgren",
  161.         2:204/404.6@fidonet.org.   Snail  mail  should  reach  me if you
  162.         write the following address on the envelope: 
  163.  
  164.             Magnus Holmgren
  165.             Rydsvägen 254  A:14
  166.             S-582 51  Linköping
  167.             SWEDEN
  168.  
  169.         Since  I  start  doing  my military service in a not too distand
  170.         future  (end  of March), it may take a little while before I can
  171.         reply to your message, so please have some patience! :) 
  172.  
  173.     DISTRIBUTION 
  174.         PicBoot  is  released  as  FREEWARE. This means that you may use
  175.         and   copy  this  program  freely,  as  long  as  the  following
  176.         restrictions are followed: 
  177.  
  178.  
  179.  
  180.     Page 3                                           (Printed 08 Feb 93)
  181.  
  182.  
  183.     PicBoot 1.00                User manual                 PicBoot 1.00
  184.  
  185.  
  186.         1)  All  files  are copied in an unmodified state. If additional
  187.         information  is  needed, place it in a separate file. Preferably
  188.         redistribute in the original archive form (*.Lha).  
  189.  
  190.         2)  The copying is done on a non-commercial and non-profit basis
  191.         only.  A  copy  fee  to  cover  media costs, postage etc. may be
  192.         charged,  and  mustn't  exceed the fee to obtain an AmigaLibDisk
  193.         from Fred Fish.  
  194.  
  195.         3)  The  copier/spreader is not claiming the Copyright © of this
  196.         program.  
  197.  
  198.         Any   exceptions   from   these  restrictions  requires  written
  199.         permission from the author, Magnus Holmgren.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.     Page 4                                           (Printed 08 Feb 93)
  241.  
  242.